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Software Product Description 



PRODUCT NAME: DECnet-VAX, Version 1 



DESCRIPTION: 

DECnet-VAX allows a suitably configured VAX/VMS 
systern to participate as a Phase 11 DECnet node in 
point-to-point computer networks. DECnet-VAX is a 
Phase 11 network product and is warranted for use 
only with Phase 11. DECnet, products supplied by 
DIGITAL. 

DECnet-VAX offers task-to-task communicatiohs, net- 
work file transfer, and network resource sharing ca- 
pabilities using the DIGITAL Network Architecture 
(DNA) protocols. DECnet-VAX communicates with ad- 
jacent nodes over synchronous communication lines. 

VAX/VIVIS programs written in VAX-11 MACRO and 
VAX-11 FORTRAN-IV-PLUS can use DECnet-VAX ca- 
pabHities, but programs executing in PDP-11 compa- 
tibility mode cannot use DECnet-VAX. The network 
functions available to a DECnet-VAX user depend, in 
part, on the configuration of the rest of the network. 
Each DECnet product offers its own functions and its 
own set of features to the user. Networks consisting 
entirely of DECnet-VAX nodes have all the functions 
described in this SPD. Networks that mix DECnet- 
VAX nodes with other DECnet products may limit the 
functions available to the DECnet-VAX user because 
some DECnet-VAX features may not be supported by 
all DECnet products. 

The Phase II products and functions available to 
users on mixed networks can be determined by com- 
parison of the SPDs for the appropriate products. The 
DECnet Phase 11 Products SPD (10.78) contains a de- 
scription of DECnet functions and identifies the com- 
mon functions available with mixed networks. 

Task-to-Task Communication 

Using DECnet-VAX, a VAX/VMS program written in 
VAX-11 MACRO or FORTRAN-IV-PLUS (either by 
transparent operation using RMS or non-transparent 
operation using the Queue I/O Request system ser- 
vice) can exchange messages with other user pro- 
grams using Phase II DECnet DNA protocols. The two 
user programs can be on the same or adjacerit DEC- 
net nodes. (Adjacent nodes control opposite ends of 
a point-to-point communication line.) If one program 
is on an adjacent node, that node can be using any 
Phase II DECnet product that supports synchronous 
communication lines. 

The DECnet messages sent and received by the two 
user programs can be in any data format. 
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Network File Management 

Using the VAX/VMS COPY command, a user can 
transfer sequential files between Phase II DECnet 
nodes. Files can be transferred in both directions 
between a locally supported VAX/VMS device and a 
device on an adjacent DECriet node that supports the 
Data Access Protocol. 

DECnet-VAX supports sequential file transfer for RMS 
supported devices. In addition, other types of files 
may be transferred where formats between the Phase 
II DECnet nodes are compatible. Between two 
VAX/VMS systems, for instance, sequential or relative 
files with fixed length, variable length, or variable 
length with-fixed-control-field records can be trans- 
ferred. 

Additional facilities allow system command files to be 
submitted to a remote node, where the list of com- 
mands must be in the format expected by the node 
responsible for their execution. Also, DECnet-VAX al- 
lows VAX/VMS command files to be received from 
other systems and executed. 

DECnet-VAX does not support network file spooling. 
A user can request only one file transfer at a time, 
and only single files can be transferred with each 
command. Wild card specifications are not permitted 
nor are directory listing commands supported. 

Network Resource Access 

File Access — File access is supported to and from 
remote DECnet systems transparent to VAX-11 
MACRO and FORTRAN IV-PLUS programs using 
RMS. 

Read, write, open and close, and delete operations 
can be initiated by local FORTRAN and MACRO pro- 
grams for files residing at remote DECnet systems. 
Other nodes supporting file access can exercise this 
capability for files located on the VAX/VMS node. Se- 
quential and random-by-record-number accesses are 
supported for incoming and outgoing file access re- 
quests. 

Down-Line System Loading — Initial memory images 
for DECnet-IIS nodes in the network can be stored 
on VAX/VMS file system devices and loaded into ad- 
jacent nodes. Load requests can come from the local 
VAX/VMS operator or from the remote node. Initial 
memory images for DECnet-11S systems to be down- 
line loaded can be generated on a VAX/VMS system 
that includes an RSX-11M or RSX-11S license. 
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Network Control Program 

The Network Control Program (NCP) performs three 
primary functions: display statistics, control network 
components, and test network components. 

Using the DECnet-VAX NCP utility, an operator can 
display the status of DECnet activity at the local node. 
The user can choose to display statistics related to 
the local node, other DECnet-VAX nodes, and com- 
munication lines, including information on traffic and 
errors. 

Using the DECnet-VAX NCP utility, the local operator 
can also perform many network control functions 
such as reconfiguring the local node's network par- 
ameters, starting and stopping lines, activating the lo- 
cal node, and down-line loading DECnet-11S sys- 
tems. 

NCP allows the user to perform a series of tests that 
ard in isolating problems. NCP can be used to send 
and receive test messages over individual lines either 
between nodes or through other controlled loopback 
arrangements. The messages can then be compared. 
Communications 

DECnet-VAX uses DMC11 communication controllers 
to interface with other network nodes. The DMC11 is 
a DMA UNIBUS peripheral that implements line con- 
trol and error recovery procedures in microcode. The 
DlViCn uses DIGITAL Data Communications Message 
Protocol (DDCMP) to provide full- or half-duplex 
communication over point-to-point synchronous lines. 
DECnet-VAX Operation 

DECnet-VAX is implemented as an Ancillary Control 
Process (ACP) under VAX/VMS with DIGITAL-sup- 
plied executive-level components and user-level pro- 
grams. 

The normal VAX/VMS protection has been incorpo- 
rated in the operation of DECnet-VAX. For example, 
all incoming connects including file access and file 
transfer requests are protected by the normal 
VAX/VMS login and file protection mechanisms. Out- 
going connects including file access and file transfer 
requests may include user password information 
which is implicitly specified via NCP, or explicitly 
specified by the user. 

DECnet-VAX Configuration and Performance 
Cost, performance, and function selection must be 
considered when deciding where nodes should be lo- 
cated and how they should be interconnected with 
communication lines. Dial-up telephone circuits are 
often best for networks with low message traffic. Oth- 
er applications require higher-speed communication 
lines. DECnet-VAX supports both types of network 
traffic over point-to-point communication lines, but 
each application must be analyzed separately by the 
user and/or a DIGITAL Software Specialist. 

Each DECnet-VAX node must be analyzed individually 
to determine its performance in a given network ap- 
plication. Network throughput and responsiveness de- 
pend on many factors, including: 

• network topology 

• CPU power and system loading 



• communication line characteristics 

• swapping overhead and scheduling priorities 

• size and distribution of network messages 

The maximum number of DMC11 lines that can be 
connected to a single DECnet-VAX node can be de- 
termined from the Communications Devices Section 
of the VAX/VMS SPD. The aggregate line speeds 
supported are burst rates, achievable during buffered 
data transfers. Sustained rates to transfer user data 
will be less than the line speed of the device(s) used 
because of network protocol overhead and other fac- 
tors listed above. At higher speeds, message pro- 
cessing time will limit total throughput. 

MINIMUM HARDWARE REQUIRED: 

Any valid VAX/VMS system configuration with one of 
the foNowing communications devices supporting one 
line: 

• DMC11-AR, -DA synchronous EIA interface 

• DMC11-AL, -MD high speed local synchronous in- 
terface 

• DMC11-AL, -MA high speed local synchronous in- 
terface 

OPTIONAL HARDWARE: 

None 

PREREQUISITE SOFTWARE: 

VAX/VMS operating system, Version 1.0 

OPTIONAL SOFTWARE: 

None 

TRAINING CREDITS: 

None 

SUPPORT CATEGORY: 

A — Software Support will be provided as stated in 
the Software Support Categories Addendum to this 
SPD. 

Installation under Category A support will convert the 
VAX/VMS system into a node with connection 
potential to a DECnet Phase II network. This installa- 
tion does not Include a demonstration of network 
connfection. 

The Customer may purchase DECnet-VAX licenses 
with options that do not include support services. The 
category of support applicable to such software is 
Category C. While a DECnet-VAX product option that 
does not include support services is connected to a 
DECnet network, the category of support applicable 
to all DECnet products in that network is Category C. 

CUSTOMER RESPONSIBILITIES: 

Before installation of the Software, the Customer 
must: 

1. Install or have installed all hardware, including 
terminals, to be used on the system. 

2. Make available to DIGITAL personnel all hard- 
ware, including terminals, to be used during in- 
stallation for a reasonable period of time each 
day, as mutually agreed upon by DIGITAL and 
the Customer, until installation is complete. 
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Delays caused by any failure to meet these responsi- 
bilities will be charged at the then prevailing rate for 
time and materials. 

PREREQUISITE SUPPORT: 

A Networl< Profile and DECnet Customer Support 
Plan covering all Intended network nodes and their 
support must be prepared jointly by the customer 
and DIGITAL. 

UPDATE POLICY: 

Software Updates, if any, released by DIGITAL during 
the one (1) year period following installation, will be 
provided to the customer for a media charge (in- 
cludes no installation). After the first year, updates, if 
any, will be made available according to then prevail- 
ing DIGITAL policies. 

ORDERING INFORMATION: 

All binary licensed software, including any subse- 
quent updates, is furnished under the licensing provi- 
sions of DIGITAL'S Standard Terms and Conditions of 
Sale, which provide in part that the software and any 
part thereof may be used on only the single CPU on 
which the software is first installed, and may be 
copied, in whole or in part (with the proper inclusion 
of the DIGITAL copyright notice and any DIGITAL 
proprietary notices on the software) only for use on 
such CPU. All source licensed software is furnished 
only under the terms and conditions of a separate 
Software Program Sources Agreement between Pur- 
chaser and DIGITAL. 

Standard options with no support services are only 
available after the purchase of one supported license. 
When a software license is ordered without support 
services, the category of support applicable to such 
software is Category C. 

A single-use license only option is a license to copy 
the software previously obtained under license, and 
use such software in accordance with DIGITAL'S 
Standard Terms and Conditions of Sale. The category 
of support applicable to such copied software is Cate- 
gory C. 



Source and/or listing options are only available after 
the purchase of at least one binary license and after a 
source license agreement is in effect. 
The following key (M, R, Y, Z) represents the distribu- 
tion media for the product and must be specified at 
the end of the order number, e.g., QED01-AY = bi- 
naries on floppy disk. 

M = 1600 bpi 9-track Magnetic Tape 

R = Microfiche 

Y = RX01 Floppy Diskette 

Z = No hardware dependency 

Standard Options 

QED01 -A— Single-use license, binaries, documen- 
tation, support services (media: Y) 

QED01 -C— Single-use license, binaries, 
documentation, no support services 
(media: Y) 

QED01 -D— Single-use license only, no binaries, no 
documentation, no support services 
(media: Z) 

Source/Listing Options 

QED01 -F— Microfiche listing's only (media: R) 
QED01 -M— All sources plus listings on microfiche 
(media: M) 

Miscellaneous Options: 

QED01 -G— Pre-delivery kit (media: Z) 

ADDITIONAL SERVICES: 

QS680 -S— DECnet Level I Services (media: Z) 

Level II services are also available. Consult the DEC- 
net Phase II Products SPD (10.78) for a description of 
Level 1 and Level II services. 
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ADDENDUM 
SOFTWARE SUPPORT CATEGORIES 



SSrfptTflp'l^? e">^ , nrilTVmp oI'^'^H^^'^ T, ^f «'9"^*^<^ Support Category A or B in the applicable Software Product 
nfrfTii c olf K, V ^ f , ^^ '"^^ °' °''^^'' """"^ '^® '="'''^"* '■e'ease at the time of delivery and will conform to the SPD 
sStwarI ^,h J dpjrnnlH"<f^ '° S7?* "^'^'^ (nonconformance of the SOFTWARE to the SPD) as deschbTd below Any 
bOFTWARE with a designated Support Category C will be furnished on an as is' basis. 

charir™'^"^*'''' ^ designated Support Category A or B, DIGITAL will provide the services set forth below without additional 

CATEGORY A _ 

1. Upon notification by customer to the nearest DIGITAL office that the computer system, Including all required prereauisite 
w^hlrth^ and software, is ready for the installation of the SOFTWARE, DIGITAL wNI install such SOFTWARE ^ anyTocaSn 
Tn n T!.T"3"°"V°'''y-®'9^' <''^> ^"'*^'* States, the District of Columbia, or a country in which DGITAL or TsubsSv 
of DIGITAL has a software service facility. The notification must be received by DIGITAL and th^sys em must Lrea^vfo^ 
ln«f 1'°"t Z'l'"" *'',';'^ <^°> '^^^^ ^"^'' ''^ '^^''^^^ °' '^'^ SOFTWARE to customer or DIGITAL wiM hTvrno obliqafon °o 

service (on site where necessary): (1) if the SOFTWARE is inoperable, apply a temporary correction TC) or mako a 
'^^l^.^XZ^I^l^i^r'''"^ ''-'''-' -^ '^^ ^'^ '^^ '-^-- to^Sre°rirwiJe'U°rm1^ce 

3. During the one (1) year period following installation, if the customer encounters a problem with the SOFTWARE which hi^ 
to nrohl! '"^'^^*«^'«,<=.«"s,ed by a SOFTWARE defect, the customer may submit an SPR to DIGITAL. DSfwIllreslnd 
M^rnton l^^^J'^,"} SPRs which are caused by defects in the current unaltered release of the SOFTWARE 4 the 

Maintenance PeriodK^al for the SOFTWARE, which reports SPRs received, code corrections, temporary corvee ions aenerlnv 
SAL7:r^nrfhi""'''m ""''°'' "°J'"" °' '""^ """""'"'''^ °' ^°^^^^*^*^ "^^^^^ Software Urates' ianj released 5 
Z^mL h^ *''^.°"?,<^Lr^'' P^"°''' *'" ^^ P''°^"^^'^ *° t^^ customer on DIGITAL'S standard distribution media as 
specified in the applicable SPD. The customer will be charged only for the media on which such updaes are orovlded 
unless otherwise stated in the applicable SPD, at DIGITAL'S then current media prices ^ provided, 

CATEGORY B 

During the one (1) year period following delivery, the services provided to the customer will be the same as set forth in 3 above. 

CATEGORY C 

SOFTWARE is provided on an as is' basis. Any software services, if available, will be provided at the then current charges 

DIGITAL shall have the right to make additional charges for any additional effort required to provide services resultinn frnm 

customer use of other than current unaltered release of the SOFTWARE operated in accordance w^h the SPD ^ 



